跳到主要内容

points export - 导出服务器成员积分

命令名称​

/points export

描述​

此命令允许你将 Discord 服务器的成员积分数据导出为 CSV 文件，用于跟踪、统计、排行榜管理和奖励发放。你可以指定积分的时间周期、设置自定义日期范围、限制导出成员的数量，以及选择性地包含特定的钱包类型。

用法​

/points export [period] [date_range] [limit] [wallet]

参数​

可选参数:​

  • [period]：积分数据的统计时间范围。
    • All：导出成员的当前积分余额（默认）。
    • Today, This Week, This Month, 7-Day, 30-Day：导出在该特定周期内累计获得的积分总数。
    • Custom：允许你使用 [date_range] 参数定义一个特定的日期范围。
  • [date_range]：设置自定义的日期范围（例如：2025-01-01,2025-12-31）。
    • 仅在 [period] 设置为 Custom 时需要填写。
  • [limit]：导出的成员数量上限。
    • 默认值为 0，表示导出所有当前积分余额大于 0 的成员。
  • [wallet]：选择要包含在导出数据中的特定钱包类型。
    • None：不包含钱包数据（默认）。
    • BTC, ETH, SOL：包含与每位成员关联的所选钱包地址。

示例​

  • 示例 1：导出所有成员的当前积分余额为 CSV 文件。

    /points export

  • 示例 2：导出过去 7 天内获得积分最多的前 100 名成员。

    /points export period:7-Day limit:100

  • 示例 3：导出自定义日期范围内所有成员获得的积分，并包含其关联的 BTC 钱包信息。

    /points export period:Custom date_range:2025-07-01,2025-07-31 wallet:BTC

注意事项​

  • 此功能仅限于 ULTIMATE 订阅等级。
  • 导出的文件格式为 CSV 文件（逗号分隔值）。
  • 如果 period 设置为 Custom，你必须在 date_range 参数中提供有效的起始和结束日期（格式为 YYYY-MM-DD）。
  • 导出非 All 周期的数据时，导出的数字代表该时间段内累计获得的积分，而非当前余额。

常见问题​

  • 问：All 和其他周期选项有什么区别？

    答：All 导出成员当前的积分余额。其他周期（例如，This Month，7-Day）导出成员在该时间段内累计获得的积分总额。

  • 问：如果我设置了 limit，但有积分的成员数量不足怎么办？

    答：导出的文件将只包含所有有积分的成员，不会创建空的条目。

  • 问：我可以导出单个成员的数据吗？

    答：此命令导出服务器范围的数据。要查看单个成员的积分，请使用相应的成员特定命令（例如：/profile）。